.TH E1432_CHANNEL_GROUP_ADD 3 E1432
.SH NAME
.nf
e1432_channel_group_add \- Add a channel to a channel group
e1432_channel_group_remove \- Remove a channel from a channel group
.fi
.IX e1432_channel_group_add(3) 3
.IX e1432_channel_group_remove(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_channel_group_add(E1432ID hw, SHORTSIZ16 group_id,
                                   SHORTSIZ16 chan_id)
SHORTSIZ16 e1432_channel_group_remove(E1432ID hw, SHORTSIZ16 group_id,
                                      SHORTSIZ16 chan_id)
.cE
.SH DESCRIPTION

\fIe1432_channel_group_add\fR adds a channel to an existing channel
group.  If the channel is already a member of the channel group, this
function does nothing.

\fIe1432_channel_group_remove\fR removes a channel from an existing
channel group.  If the channel is not currently a member of the
channel group, this function does nothing.

There is nothing wrong with deleting all channels from a channel group
using \fIe1432_channel_group_remove\fR.  It is valid to have a group
with no channels in it.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIgroup_id\fR is the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR.

\fIchan_id\fR is the ID of a single channel.

When adding channels to or deleting channels from a channel group,
these functions attempt to preserve the current "trigger master"
setting if there is one.  However, with
\fIe1432_channel_group_remove\fR it is possible that the trigger
master module is no longer in the group.  In this case, a new trigger
master is picked arbitrarily.

.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
\fIe1432_channel_group_add\fR and \fIe1432_channel_group_remove\fR
return 0 if successful, or a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_assign_channel_numbers, e1432_create_channel_group,
e1432_delete_channel_group, e1432_set_trigger_master
.ad
